home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / FMSSORT.ZIP / FMSSORTR.DOC < prev   
Encoding:
Text File  |  1994-04-25  |  4.9 KB  |  107 lines
  1.                 FMSSORT.EXE :: RBBS-PC FMS FILE SORT UTILITY
  2.  
  3.         FmsSort will sort your FMS file directory and keep your extended
  4. descriptions.  It will sort in date order or alphabetically, and in both
  5. ascending or descending order.
  6.  
  7.         FmsSort will sort both old and new style directories. Oldstyle
  8. directories (those without a fixed lenght line) take absolutley forever
  9. to write out.  This is due to the support for extended lines and
  10. presumption by the programer that they aren't being used much. If it
  11. becomes neccessary the registered version will be speeded up and a switch
  12. will be added to remove extended line support.
  13.  
  14.         Running syntax is displayed by starting the program without any
  15. arguments.  Three parameters are required, a fourth controls the ascending
  16. or descending sort order (default is ascending). The fifth will be used
  17. only if you have oldstyle .DIR's.
  18.  
  19.         FmsSort is limited by memory and the number of lines it can sort
  20. with your memory configuration will be displayed on the syntax display.
  21. Typically with 528000 bytes available memory FmsSort will sort an FMS file
  22. of 32500+ lines (well over two megs).
  23.  
  24.         Disk space equal(a bit more) to the size of the directory is required.
  25.  
  26.         Fmssort will ONLY retain 10 extended description lines. This will
  27. reported as an ERROR and the program execution will stop.
  28.         FmsSort(registered) will retain 20 extended description lines,
  29. and you will be warned in the check portion of FmsSort.
  30.         In both cases this will abort the program and will have to be fixed
  31. for the program to proceed.  (I would also like to know why you need a whole
  32. screen display per file :)
  33.  
  34.         Note:  If you are using RBBS's free text lines (those begining with
  35.         an asterisk '*') FmsSort will not be able to guarantee placement.
  36.         In alphabetical sortmode it is suggested that the asterisk be
  37.         followed by a space e.g. * BLAH, will float the free text lines to
  38.         the top in an ascending sort and to the bottom in a descending sort.
  39.         If you leave out  the space e.g. *BLAH  the line will go with
  40.         the B's. Date mode will always bring the free text lines to the top
  41.         in a descending sort and to the bottom in a ascending sort.
  42.  
  43.         FmsSort(registered) is useful in Batch file for general maintanence
  44. to keep directories neat and in order catching format errors in a log file,
  45. etc. It can also be used to merge fms's.
  46.         For example if you get files on the filebone you could have
  47. a batch setup to megre the files.bbs into your master for each area:
  48.  
  49. COPY MASTER.DIR + \path\FILES.BBS + \diffpath\FILES.BBS
  50. FmsSort master.dir newfms.dir alpha
  51. rem you could check error return here
  52. del master.dir
  53. ren newfms.dir master.dir
  54.  
  55. The above copies the files.bbs stuff into master.dir then sorts
  56. creating a new dir giving you a chance to check the errorlevel
  57. return.  Then you can del and rename. Or:
  58.  
  59. COPY MASTER.DIR + \path\FILES.BBS + \diffpath\FILES.BBS TEMP.dir
  60. FmsSort temp.dir master.dir alpha
  61.  
  62. This will merge the files.bbs and master to a new file temp.dir.
  63. Then you can sort the new file outputing master.dir.  The old
  64. master.dir will be renamed by FmsSort to be deleted or saved.
  65.  
  66. This assumes you have figured out TICK so that Files.BBS is in
  67. proper FMS format :)
  68.  
  69. These are the errolevel FmsSort will exit with if unsuccessful:
  70. /*  errorlevel 1 - argument count error
  71.     errorlevel 2 - file error origional fms open/acess
  72.     errorlevel 3 - file error creating/renaming new fms 
  73.     errorlevel 4 - file error new fms open/acess
  74.     errorlevel 5 - missing or unusable sorttype
  75.     errorlevel 6 - insufficient disk space
  76.     errorlevel 7 - read error
  77.     errorlevel 8 - not an FMS file 
  78.     errorlevel 9 - FMS file format error
  79.     errorlevel 10 - read error sourcefile
  80.     errorlevel 11 - far heap memory allocation error
  81.     errorlevel 12 - near heap memory allocation error
  82.     errorlevel 13 - line number increment error 
  83. */
  84.  
  85. If you have any problems please let me know.
  86.     Charles Arden Brill
  87.     8:918/1
  88.     1:343/81
  89.     LETTERS RBBS (206)524-4811
  90.  
  91. PLEA:
  92.         If you wish the expanded capabilities FMSSORTR.EXE is available for
  93. Ten Dollars. FMSSORTR.EXE will allow up to 20 extended lines per description.
  94. No pause at finish for batch file operation.  Any enhancements will go into
  95. the registered version. This will also secure your place in the Goodwill
  96. Hall of Fame because it is the right thing to do.
  97.  
  98. Break down and use a pen and envelope and remit Cash or Check (preferable to
  99. you I would guess) to
  100.     Charles Arden Brill
  101.     4812 NE 103rd 
  102.     Seattle Wa 98125
  103. You might make sure there is a name and address for me to send it to :)
  104. Or if you are totally electronically oriented include your FIDO RBBS
  105. addresses or BBS numbers and it will be transmitted.
  106. ---------------------------- THANK YOU ----------------------------
  107.